home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbprrow.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.3 KB  |  55 lines
  1. .Na "dbprrow" 
  2. .Aa
  3. .Fu
  4. Print all the rows returned from \*S.
  5. .Ih "results rows, printing"
  6. .Ih "rows, printing"
  7. .Ih "columns, printing"
  8. .Ih debugging
  9. .Sy
  10. .Sf "extern int DbColwidth;"
  11. .Sf "RETCODE dbprrow(dbproc)"
  12. .Sp "DBPROCESS" "*dbproc"
  13. .Co
  14. .Bl
  15. This routine displays, on the default output device and in a default format, the rows 
  16. for a set of query results.
  17. This routine reads and prints all the rows.
  18. It saves the trouble
  19. of calling routines such as \f2dbbind()\f1 and \f2dbnextrow()\f1,
  20. but it prints only in a single, predetermined format.
  21. .Bl
  22. The application can call
  23. \f2dbprrow()\f1 once
  24. .I "dbresults()"
  25. returns SUCCEED.
  26. .Bl
  27. When using this routine, you do not need to call \f2dbnextrow()\f1 to loop through
  28. the rows.
  29. .Bl
  30. \f2dbprrow()\f1 is useful primarily for debugging.
  31. .Bl
  32. \f3Note for Macintosh programmers:\f1  Because \f2dbprrow()\f1 calls \f2printf()\f1,
  33. it is valid only in an MPW Tool.
  34. .Bz
  35. .Pa
  36. .Pi dbproc
  37. A pointer to the DBPROCESS structure that provides the connection
  38. for a particular front-end/\*S process.  It contains all the
  39. information that \*L uses to manage communications and data between the
  40. front end and \*S.
  41. .Pi DbColwidth
  42. A global variable that
  43. .I dbprrow()
  44. uses to calculate the width of each output line.  It is initialized to 80
  45. by \*L.
  46. .in -.375i
  47. .Re
  48. .br
  49. SUCCEED or FAIL.
  50. .Sa
  51. dbbind,
  52. dbnextrow,
  53. dbprhead,
  54. dbresults
  55.